Api.ConfigureDc 方法
配置分佈時鐘 (DC) 選項。分佈時鐘允許從站週期與 KINGSTAR 週期同步,強烈建議任何運動應用程式皆需避免震動。
- 主站偏移:參考時鐘為 EtherCAT 網路中具有 DC 功能的第一個從站時鐘。
- 總線偏移:參考時鐘為主站時鐘。
命名空間:IntervalZero.KINGSTAR.Local.Api
組合: IntervalZero.KINGSTAR.Local.Api (於 IntervalZero.KINGSTAR.Local.dll) 版本:4.4.0.0
語法
public KsError ConfigureDc(
bool Active,
bool CheckStatus,
bool MasterShift,
int ReferenceIndex
)
Public Function ConfigureDc(
Active As Boolean,
CheckStatus As Boolean,
MasterShift As Boolean,
ReferenceIndex As Integer
) As KsError
參數
Active
型別:bool
true:啟用 DC 同步;false:停用 DC 同步。預設為 true。
CheckStatus
型別:bool
啟動時啟用 DC 抖動檢查。同步完成後,裝置會切到運作狀態 (Op),此將會使啟動過程增加 15 秒,預設為 true。
MasterShift
型別:bool
選擇偏移模式。true:主站偏移;false:總線偏移,預設為 false。
總線偏移表示 EtherCAT 從站跟隨主站(電腦)時鐘;主站偏移表示從站與主站跟隨稱作 "參考時鐘 (Reference Clock)" 的從站時鐘。依預設,參考時鐘為總線上第一個支援 DC 功能的從站。
注意:從站時鐘相較於電腦時鐘準確,因此主站偏移較為穩定。然而,主站偏移會修改電腦時鐘的速度,此將影響電腦上所有的時間戳記,若電腦上同時使用其他通訊協定,此將產生問題。
ReferenceIndex
型別:int
選擇作為參考時鐘的裝置。此參數為從站 ID,即裝置的 EtherCAT ID,其對應於裝置在 EtherCAT 迴路中的位置。此 ID 以 0 為起始且不受別名影響。
注意:ReferenceIndex 尚未實作。
回傳值
方法的回傳代碼。
備註
- 此方法須在 Create 或 CreateAsync 後及 Start 前呼叫。
- 停用 DC 檢查雖可減少 10 秒的啟動時間,但一旦系統啟動,將不再保證同步準備就緒。當系統切到操作狀態 (Op) 後,時鐘需要約 1 分鐘的時間進行同步。因此我們建議您維持 DC 檢查啟用狀態。
- 在主站偏移下,從站較為穩定但主站較不穩定,請在必要時才使用主站偏移。
可用的 EtherCAT 狀態
ecatOffline
範例
N/A
參見